Skip to main content

ContentApi

All URIs are relative to **

MethodHTTP requestDescription
contentAddCarPostPOST /content/add-carAdd Car object
contentAddIpfsPostPOST /content/add-ipfsAdd IPFS object
contentAddPostPOST /content/addAdd new content
contentAggregatedContentGetGET /content/aggregated/{content}Get aggregated content stats
contentAllDealsGetGET /content/all-dealsGet all deals for a user
contentBwUsageContentGetGET /content/bw-usage/{content}Get content bandwidth
contentCreatePostPOST /content/createAdd a new content
contentDealsGetGET /content/dealsContent with deals
contentEnsureReplicationDatacidGetGET /content/ensure-replication/{datacid}Ensure Replication
contentFailuresContentGetGET /content/failures/{content}List all failures for a content
contentIdGetGET /content/{id}Content
contentImportdealPostPOST /content/importdealImport a deal
contentListGetGET /content/listList all pinned content
contentReadContGetGET /content/read/{cont}Read content
contentStagingZonesGetGET /content/staging-zonesGet staging zone for user
contentStatsGetGET /content/statsGet content statistics
contentStatusIdGetGET /content/status/{id}Content Status

contentAddCarPost

Add Car object

This endpoint is used to add a car object to the network. The object can be a file or a directory.

Example

 contentAddCarPost  ignore-dupes=value  filename=value

Parameters

NameTypeDescriptionNotes
bodystringCar
ignoreDupesstringIgnore Dupes[optional]
filenamestringFilename[optional]

Return type

(empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not Applicable
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

contentAddIpfsPost

Add IPFS object

This endpoint is used to add an IPFS object to the network. The object can be a file or a directory.

Example

 contentAddIpfsPost  ignore-dupes=value

Parameters

NameTypeDescriptionNotes
bodyUtil.ContentAddIpfsBodyIPFS Body
ignoreDupesstringIgnore Dupes[optional]

Return type

(empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not Applicable
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

contentAddPost

Add new content

This endpoint is used to upload new content.

Example

 contentAddPost  coluuid=value  replication=value  ignore-dupes=value  lazy-provide=value  dir=value

Parameters

NameTypeDescriptionNotes
dataFileFile to upload
filenamestringFilenam to use for upload[optional]
coluuidstringCollection UUID[optional]
replicationintegerReplication value[optional]
ignoreDupesstringIgnore Dupes true/false[optional]
lazyProvidestringLazy Provide true/false[optional]
dirstringDirectory[optional]

Return type

Util.ContentAddResponse

Authorization

bearerAuth

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

contentAggregatedContentGet

Get aggregated content stats

This endpoint returns aggregated content stats

Example

 contentAggregatedContentGet content=value

Parameters

NameTypeDescriptionNotes
contentstringContent ID

Return type

string

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not Applicable
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

contentAllDealsGet

Get all deals for a user

This endpoint is used to get all deals for a user

Example

 contentAllDealsGet  begin=value  duration=value  all=value

Parameters

NameTypeDescriptionNotes
beginstringBegin
durationstringDuration
allstringAll

Return type

(empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not Applicable
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

contentBwUsageContentGet

Get content bandwidth

This endpoint returns content bandwidth

Example

 contentBwUsageContentGet content=value

Parameters

NameTypeDescriptionNotes
contentstringContent ID

Return type

(empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not Applicable
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

contentCreatePost

Add a new content

This endpoint adds a new content

Example

 contentCreatePost  ignore-dupes=value

Parameters

NameTypeDescriptionNotes
reqUtil.ContentCreateBodyContent
ignoreDupesstringIgnore Dupes[optional]

Return type

(empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not Applicable
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

contentDealsGet

Content with deals

This endpoint lists all content with deals

Example

 contentDealsGet  limit=value  offset=value

Parameters

NameTypeDescriptionNotes
limitintegerLimit[optional]
offsetintegerOffset[optional]

Return type

(empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not Applicable
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

contentEnsureReplicationDatacidGet

Ensure Replication

This endpoint ensures that the content is replicated to the specified number of providers

Example

 contentEnsureReplicationDatacidGet datacid=value

Parameters

NameTypeDescriptionNotes
datacidstringData CID

Return type

(empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not Applicable
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

contentFailuresContentGet

List all failures for a content

This endpoint returns all failures for a content

Example

 contentFailuresContentGet content=value

Parameters

NameTypeDescriptionNotes
contentstringContent ID

Return type

string

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not Applicable
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

contentIdGet

Content

This endpoint returns a content by its ID

Example

 contentIdGet id=value

Parameters

NameTypeDescriptionNotes
idintegerContent ID

Return type

(empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not Applicable
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

contentImportdealPost

Import a deal

This endpoint imports a deal into the shuttle.

Example

 contentImportdealPost

Parameters

NameTypeDescriptionNotes
bodyMain.importDealBodyImport a deal

Return type

(empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not Applicable
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

contentListGet

List all pinned content

This endpoint lists all content

Example

 contentListGet

Parameters

This endpoint does not need any parameter.

Return type

array[string]

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not Applicable
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

contentReadContGet

Read content

This endpoint reads content from the blockstore

Example

 contentReadContGet cont=value

Parameters

NameTypeDescriptionNotes
contstringCID

Return type

(empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not Applicable
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

contentStagingZonesGet

Get staging zone for user

This endpoint is used to get staging zone for user.

Example

 contentStagingZonesGet

Parameters

This endpoint does not need any parameter.

Return type

(empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not Applicable
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

contentStatsGet

Get content statistics

This endpoint is used to get content statistics. Every content stored in the network (estuary) is tracked by a unique ID which can be used to get information about the content. This endpoint will allow the consumer to get the collected stats of a conten

Example

 contentStatsGet  limit=value  offset=value

Parameters

NameTypeDescriptionNotes
limitstringlimit
offsetstringoffset

Return type

(empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not Applicable
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

contentStatusIdGet

Content Status

This endpoint returns the status of a content

Example

 contentStatusIdGet id=value

Parameters

NameTypeDescriptionNotes
idintegerContent ID

Return type

(empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not Applicable
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]